home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / disk / cdrom / acdb.lha / acdb / acdb.doc < prev    next >
Text File  |  1999-01-03  |  4KB  |  124 lines

  1.  
  2.   acdb v0.4 (03.01.99)
  3.   FREEWARE
  4.   ©1999, Piotr Gapiïski <narg@polbox.com>
  5.  
  6.  
  7. [PRAWA AUTORSKIE]
  8.   WERSJA BETA DO TESTOWANIA!
  9.   AUTOR NIE PONOSI ODPOWIEDZIALNOÔCI ZA EWENTUALNE STRATY SPOWODOWANE
  10.   UÛYTKOWANIEM PROGRAMU!
  11.  
  12.  
  13. [PROGRAM]
  14.   acdb (amiga cd [data] base) to program umoûliwiajâcy zaimportowanie opisu pîyty
  15.   kompaktowej cd-da (audio) z internetowej bazy danych i zapisanie na dysku lokalnym
  16.   w formacie zgodnym ze SCDP (format rozpoznawany przez wiëkszoôê amigowych
  17.   cd-playerów).
  18.  
  19.  
  20. [WYMAGANIA]
  21.   1. komputer AMIGA, OSv37+ (2.04+)
  22.   2. TCP/IP (bsdsocket.library v4+)
  23.   3. reqtools.library v38+
  24.  
  25.  
  26. [URUCHOMIENIE]
  27.   Program moûna uruchamiaê zarówno z poziomu CLI jak i WORKBENCH'a z tym, ûe w tym
  28.   drugim przypadku moûliwe jest przekazanie przez TOOLTYPE ikonki dodatkowych
  29.   parametrów.
  30.  
  31.   DEVICE=<device name>
  32.   okreôla sterownik przez który program bëdzie pobieraî dane z CD-ROMu
  33.   domyôlnie: cd.device
  34.  
  35.   UNIT=<number>
  36.   numer urzâdzenia jako które jest podîâczony CD-ROM
  37.   domyôlnie: 0
  38.  
  39.   HOST=<cddb host>
  40.   okreôla adres internetowego serwera cddb
  41.   domyôlnie: www.cddb.com
  42.  
  43.   PORT=<cddb port>
  44.   okreôla port przez który bëdzie nawiâzana komunikacja z serwerem cddb
  45.   domyôlnie: 80
  46.  
  47.   DISKPATCH=<dir>
  48.   okreôla katalog do którego bëdâ zapisywane odczytane opisy pîyt kompaktowych
  49.   domyôlnie: PROGDIR:disks
  50.  
  51.   ICONFILE=<file without .info>
  52.   okreôla nazë pliku (bez rozszerzenia .info), który bëdzie uûywany gdy program
  53.   bëdzie zikonifikowany
  54.   domyôlnie: PROGDIR:acdb
  55.  
  56.   PUBSCREEN=<pub screen name>
  57.   okreôlna nazwë ekranu publicznego na którym program ma sië uruchomiê
  58.   domyôlnie: ekran workbench'a
  59.  
  60.  
  61. [DZIAÎANIE]
  62.   Tok postëpowania jest prosty:
  63.   1. wîoûyê pîytke CD do napëdu
  64.   2. nacisnâê przycisk 'CD'
  65.   3. jeûeli nie nastâpiîy ûadne bîëdy, opis pîytki zostanie wyôwietlony
  66.   4. nacisnâê przycisk 'Save' w celu zapisania danych na dysk
  67.   5. go to 1.
  68.  
  69.  
  70. [TIPSY]
  71.   1. Program zapisuje poîoûenie i wymiary gîównego okienka do pliku
  72.      ENV:acdb
  73.      moûna wiëc plik ten przekopiowaê do katalogu ENVARC: a zawarte w nim
  74.      ustawienia bëdâ ustawieniami domyôlnymi programu
  75.  
  76.  
  77. [ZMIANY]
  78.   acdb 0.4 (03.01.99)
  79.   1. czasami, gdy wysyîane jest ûâdanie znalezienia pîytki maîo znanej (i której
  80.      prawdopodobnie nie ma w bazie danych) program blokuje sië (nie zawiesza!)
  81.      na jakiô czas, po upîywie którego wszystko wraca do normy (ok. 2,3 min.)
  82.   *  powodem takiego zachowania sië programu byîy zbyt maîe bufory na wysyîane
  83.      do CDDB zapytania; poprawione
  84.   2. nie do koïca dziaîa moûliwoôê przerwania pobierania danych z cddb
  85.      (gadûet CANCEL)
  86.   *  obsîuga 'progress indicatora' odbywa sië teraz TYLKO podczas odczytywania
  87.      danych z serwera CDDB wiëc gdy serwer nie wysyîa danych, nie moûna przerwaê
  88.      odbioru (trzeba czekaê na TIMEOUT - 2, 3 minuty lub wyîâczyê dostëp do sieci)
  89.  
  90.  
  91. [ZNANE BÎËDY]
  92.   Do tej chwili (acdb, v0.4, 03.01.99) zostaîy wykryte nastëpujâce bîëdy:
  93.   1. jeûeli program zostaî uruchomiony na innym ekranie niû publiczny
  94.      (TOOLTYPE/PUBSCREEN) to gdy program zostanie zikonifikowany a ekran w tym
  95.      samym czasie zamkniëty nastâpi zawieszenie systemu
  96.   2. opisy pîytek nie zawierajâ polskich znaków (i raczej nie bëdâ ich zawieraîy)
  97.      to raczej nie jest bîâd - po prostu serwery CDDB obsîugujâ tylko kod Latin-1
  98.   3. miëdzy odczytaniem opisu pîyty a zapisaniem go na dysk NIE MOÛNA zmieniaê
  99.      pîyty w napëdzie bo dane zostanâ zapisane pod bîëdnâ nazwâ
  100.   4. czasami w okienku wyboru pîytek (AVAILABLE MATCHES) jest wyôwietlany znak CR
  101.      na koïcu opisu pîyty
  102.  
  103.  
  104. [KONTAKT Z AUTOREM]
  105.   Wszelkie raporty o bîëdach, sugestie i komentarze proszë przesyîaê na adres:
  106.   narg@polbox.com
  107.   http://free.polbox.pl/n/narg
  108.  
  109.  
  110. [TECHNICZNE INFORMACJE]
  111.   Program powstaî w jëzyku AmigaE i uûywa nastëpujâcych moduîów:
  112.   1.  EASYGUI, © Wouter, Jason
  113.   2.  ICONIFY PLUGIN, © Piotr Gapinski
  114.   3.  AFC/PARSE, © Fabio Rotondo
  115.   4.  FILE, © Wouter
  116.  
  117.   Podczas pisania programu byîy wykorzystywane nastëpujâce materiaîy:
  118.   1.  @(#)cddb.howto 1.27 (98/12/09)
  119.   2.  (SCSI) X3T9.2 WORKING DRAFT (7-SEP-93)
  120.   3.  RFC-1945 (HTTP1.0)
  121.   4.  amiTCP/IP HTTP/GET example
  122.   5.  BGUI BGPlayer example
  123.  
  124.